Accesses the resource entries in a resource map in memory directly.

SInt32 RsrcMapEntry (
    Handle theResource
);

theResource

A handle to a resource.

function result

The offset of the specified resource’s entry from the beginning of the resource map in memory. If it doesn’t find the resource entry, the function returns 0, and the ResError function returns the result code resNotFound. If you pass a handle whose value is NULL, this function returns arbitrary data, but ResError returns the result code noErr.

DISCUSSION

Because the Resource Manager provides functions for opening, retrieving, and changing resources, there’s usually no reason to access a resource map directly. To avoid damaging the file for which it’s called, you should use RsrcMapEntry extremely carefully.

AVAILABILITY

Not supported in Carbon. Not available in Carbon.

CARBON NOTES

This function provides an interface based on the map handle format. You won’t be able to use the map handle to walk the resource chain. Apple will provide a new API in Carbon for managing the resource chain.

© 2000 Apple Computer, Inc. — (Last Updated 5/8/2000)